Range Map Files

This version of Rayshade can generate not only images, but also Range Maps (also known as <#1232#>Z Buffers<#1232#>). A Range Map is a two dimensional image, where each pixel is the floating point distance from the image plane^D.1to the object in the scene. This is especially useful for generating synthetic data sets for use in Computer Vision research, e.g. depth from stereo and shape from shading. Those techniques all attempt to reconstruct 3D information from 2D images, and having the actual Range Map available makes a quantitative analysis of the accuracy of reconstruction possible.

Range Maps are rendered for single frames^D.2 from the same viewpoint used to generate images, with the same window size and resolution. To enable Range Map output, use the <#1236#>-z<#1236#> command line option:

<#6353#><#6353#>: <#2032#>-z<#2032#> <#2033#>filename<#2033#>
Generate a Range Map (i.e., Z buffer).

The format of the file is specified by the filename suffix. Three formats are available:

<#6354#>.hf<#6354#>: ;SPMnbsp;;SPMnbsp; Heightfield Format -- The most compact format, see Appendix C for a complete description. This is the default output format.
<#6355#>.txt<#6355#>: ;SPMnbsp;;SPMnbsp; Text Format -- After some opening comments, each line will correspond to a single row in the image. Pixel distances on each row are represented as text (e.g. <#1242#>5.45454<#1242#>) and are separated by spaces.
<#6356#>.etxt<#6356#>: ;SPMnbsp;;SPMnbsp; Expanded Text Format -- After some opening comments, each line will correspond to a single <#1243#>pixel<#1243#>:
integer X-coord ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp; integer Y-coord ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp; float Distance
Since each output line contains information on just one pixel, a blank line is inserted when the Y coordinate changes (i.e., when the data corresponds to a new scanline).

In all three formats, a distance of <#1247#>-1000<#1247#> is used to represent the background; this value is unique since all visible objects will have a distance greater than zero.

Why three formats? Heightfield Format is useful because it's very compact and can also be used as <#1248#>input<#1248#> to Rayshade; Text Format is easier to process in shell scripts; and Expanded Text Format is just right for quick displays using the <#1249#>GNUPlot<#1249#> display tool.